Crear Contacto

• Introducción
• Ejemplo de uso
• Ejemplo de respuesta
• Parámetros que recibe

Creación

Para crear un contacto debemos agregar un token en Headers de tipo Authorization con el token necesario, este token deben solicitarse a Domus.
Es importante anotar que los parámetros deben ser enviados a través de algo como form_params o similar, no se deben enviar directamente en la URL.

Antes se deben consultar los métodos generales de tipos de teléfono, indicativos de teléfono y recursos.

Ejemplo de uso

{success} POST: /api/contacts

use GuzzleHttp\Client;

$client = new Client();
$res = $client->request("POST", "{$endpoint}/api/contacts", [
    "form_params" => [
        "name": "Nombre contacto", //Nombre contacto
        "last_name": "Apellidos contacto", // (optional)
        "identification": "1026295959", // (optional)
        "email": "[email protected]", // Obligatorio según configuración en sistema
        "description": "Descripción para el contacto", //optional 
        "birthdate": "2024-02-06", // (optional)
        "picture_url": "www.link_photo.com", // (optional)
        "phones": [
            {
                "phone": "3215453585", // Obligatorio según configuración en sistema
                "phone_type": 2, // Obligatorio si se agrega "phone"
                "phone_indicative": 1, // Obligatorio si se agrega "phone"
            },
            {
                "phone": "31569959", // Obligatorio según configuración en sistema
                "phone_type": 1, // Obligatorio si se agrega "phone"
                "phone_indicative": 2, // Obligatorio si se agrega "phone"
            },
        ]
        "origin": 2, // Portal del cual se ingresa (Recursos)
        "temperature": "20" // De 1 al 100
        "assign_to_profile": 4 //id perfil a asignar (consultar en General/Perfiles)
        "branch": 3 //Esta opción es valida si no se envía la propiedad "assign_to_profile"
    ]
]);

$usuario = json_decode($res->getBody(), true);
return $usuario;

Ejemplo de respuesta

{
    "code": 200,
    "message": "Contacto guardado correctamente",
    "data": {
        "name": "Nombre contacto",
        "last_name": "Apellidos contacto",
        "email": "[email protected]",
        "identification": "1026295959",
        "birthdate": "2024-02-06",
        "description": "Descripción para el contacto",
        "picture_url": "www.link_photo.com",
        "contact_status_id": 1,
        "contact_status_type_id": 1,
        "source_id": 2,
        "platform_id": 1,
        "last_gestion_date": "2024-04-10T21:31:40.236031Z",
        "profile_id": 4,
        "created_by_id": 1,
        "updated_by_id": 1,
        "branch_id": 1,
        "company_id": 1,
        "country_id": 1,
        "temperature_value": "20",
        "temperature_id": 1,
        "updated_at": "2024-04-10T21:31:40.000000Z",
        "created_at": "2024-04-10T21:31:40.000000Z",
        "id": 171
    }
}

Parámetros que recibe

Por From Params

Estos son los valores requeridos para la creación del usuario